home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 541 / mdformat / mdformat.txt < prev   
Encoding:
Text File  |  1985-11-19  |  2.5 KB  |  53 lines
  1.                        READ_ME.TXT for MDFORMAT.PRG:
  2.                              by Clark A. Hay
  3.                                 07/19/91
  4.           ***  MDFORMAT.PRG runs in Medium Resolution Only!  ***
  5.  
  6.                             - DESCRIPTION: -
  7.     Musical Disk Formatter is a simple little program that plays some
  8. music while it formats your disk.  It was written in 68000 assembly
  9. language using Assempro from Abacus Software.  While this may prove to
  10. be an amusing utility program, its main purpose is tutorial - which is
  11. why I have included the complete (heavily commented) source code for it.
  12.  
  13.                              - RESOLUTION: -
  14.     As it stands, this program runs in MEDIUM RESOLUTION only, but the
  15. code can be modified quite easily so that it can run in any resolution.
  16.  
  17.                             - HOW IT WORKS: -
  18.     Created to look and work much as a GEM dialogue box, the program
  19. avoids making any calls to GEM's VDI or AES - relying solely on Line_A
  20. calls and a few from TOS, BIOS and XBIOS.  The user may select options
  21. using the mouse, or the keyboard.  A "Return" will format the disk
  22. using the options that are set, and pressing the "Esc"ape key lets you
  23. exit the program.
  24.  
  25.                               - OPTIONS: -
  26.     Formatting uses 10 sectors per track, and the user may select
  27. between drives A or B, single or double sided disk, 80 or 82 tracks.
  28. It does NOT produce a sector skewed track as with "Twister.Prg", so
  29. don't expect any disk read/write speed ups.
  30.  
  31.                          - FORMATTING STATUS: -
  32.     The music begins when the "Format" option is selected with the
  33. mouse or via the keyboard.  The "music" [sic] played is my own
  34. version of the theme song to the movie "Midnight Express".  Format
  35. status reads "Working" and a progress bar is filled in as each track
  36. is formatted.  If an error occurs, a "falling bomb/explosion" sound
  37. occurs and formatting stops, with the message "Error" displayed in
  38. the status box.  Successful formatting leaves you with the message
  39. that it is "Waiting" for the next command.
  40.  
  41.              - NOTE TO BEGINNING/INTERMEDIATE PROGRAMMERS: -
  42.     If you are a programmer, look at the source code.  In it are some
  43. fairly useful pieces of code, and plenty of room for enhancements or
  44. improvement.  Please feel free to use, steal or modify the code.  All
  45. I ask is that you share any useful insights, improvements or routines
  46. with the rest of us.
  47.  
  48.                                 Enjoy!
  49.                              Clark A. Hay
  50.                        Genie user handle "E.T."
  51.  
  52.